home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / wrap10.zip / DEBUGNXT.DOC < prev    next >
Text File  |  1992-09-01  |  6KB  |  160 lines
  1. ================================================================================
  2.        DEBUGNXT.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  3.        DEBUGN86.SYS (8086):  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  4. ================================================================================
  5.  
  6.   DEBUGNXT.SYS is a companion device driver to WRAPPER.SYS which enables
  7.   debugging of the intialization phase of device drivers.  It complements
  8.   WRAPPER's special support for loading debuggers, but may also be used
  9.   independently of WRAPPER.  DEBUGNXT triggers the debug interrupt (INT 03)
  10.   in such away as to trap a debugger at the first instruction of the
  11.   the next device following DEBUGNXT in CONFIG.SYS.  DEBUGNXT will operate
  12.   only once for each instance that it is loaded, but may be loaded multiple
  13.   times in the CONFIG.SYS file.  High memory users may load WRAPPER and/or
  14.   DEBUGNXT into high memory with a device loader, or using MS-DOS 5.0's
  15.   DEVICEHIGH command.
  16.  
  17. ================================================================================
  18.  
  19. (Requirements)::
  20.  
  21.         * 186 processor or better (WRAPP86.SYS and DEBUGN86.SYS are
  22.           included to support 8086/8088 processors)
  23.         * Requires MS-DOS Version 3.1 or better
  24.  
  25. ================================================================================
  26.  
  27. (Installation)::
  28.  
  29.         (CONFIG.SYS)::
  30.  
  31.         Install DEBUGNXT.SYS in your CONFIG.SYS as a DEVICE
  32.  
  33.         DEVICE=DEBUGNXT.SYS [options]
  34.  
  35.         An example of how to use DEBUGNXT.SYS to debug MYDEVICE.SYS follows.
  36.         The debugger is MS-DOS's DEBUG (loaded by WRAPPER).
  37.  
  38.            DEVICE=WRAPPER.SYS /C-/D/M32 C:\DEBUG.EXE
  39.            DEVICE=DEBUGNXT.SYS
  40.            DEVICE=MYDEVICE.SYS
  41.  
  42.            (Display at boot-up):
  43.  
  44.            WRAPPER.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  45.                        :  User interrupt 60h hooked
  46.  
  47.            (Debug's prompt):
  48.  
  49.            -a 100                               ; assemble at 0100
  50.            1234:0100 int 60                     ; the instruction "int 60"
  51.            -g                                   ; go
  52.  
  53.            DEBUGNXT.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  54.  
  55.            (Stops at first instruction of MYDEVICE's strategy routine):
  56.  
  57.            AX=0000 BX=03E6 CX=0000 DX=0000 SP=05A6 BP=0000 SI=0000 DI=0000
  58.            DS=0C96 ES=9087 SS=9087 CS=0C96 IP=0016 NV UP EI PL NZ NA PO NC
  59.            0C96:0016 2E            CS:
  60.            0C96:0017 891E1200      MOV     [0012],BX          CS:0012=0000
  61.            -
  62.  
  63.         All switch options and possible messages for DEBUGNXT are detailed
  64.         below:
  65.  
  66. ================================================================================
  67.  
  68. (Syntax)::
  69.  
  70.         The only thing to remember about syntax for the command line is
  71.         that just about anything works.  What this means is that you
  72.         should be able to type in the options on the command line the
  73.         way they make sense to you.
  74.  
  75.         To illustrate this point, the following command line example
  76.         is mutated several different ways.
  77.  
  78.         DEVICE=DEBUGNXT.SYS /R- /P-
  79.         DEVICE=DEBUGNXT.SYS -R- -P-
  80.         DEVICE=DEBUGNXT.SYS -R--P-
  81.  
  82.         ... and so on.
  83.  
  84. (Switch Options)::
  85.  
  86.         (REPORT)::      R[+ or -]       (toggle:  default +)
  87.  
  88.         Use /R- to disable messages from WRAPPER.SYS.
  89.  
  90.         (PAUSE)::       P[+ or -]       (toggle:  default +)
  91.  
  92.         Use /P+ to enable the pause after the any report messages.
  93.  
  94.         (NOPAUSE)::     N[+ or -]       (toggle:  default -)
  95.  
  96.         Use /N+ to never pause after the report, even if there
  97.         are errors.  This switch can be used if your configuration
  98.         generates a warning or error message which you choose to ignore.
  99.         *  everything in square brackets "[]" is optional
  100.  
  101. (CONFIG.SYS Line)::
  102.  
  103.         DEVICE=DEBUGNXT.SYS [/R-][/P+][/N-]
  104.  
  105.         device default:  /R+/P-/N-
  106.  
  107.         *  Report status messages
  108.         *  Don't Pause after report
  109.         *  Pause on errors or warnings
  110.  
  111. ================================================================================
  112.  
  113. (Report Format)::
  114.  
  115.         DEBUGNXT.SYS :  Ver. 1.0, Copyright (1992) by Philip B. Gardner
  116.                ERROR :  (Error Messages)
  117.              WARNING :  (Warning Messages)
  118.               ADVICE :  (Advisory Messages)
  119.                      :  (Report Messages)
  120.                      :  (Allocation Status)
  121.                PAUSE :  Press any key to continue... 
  122.  
  123. ================================================================================
  124.  
  125. (Error Messages)::
  126.  
  127.         MS-DOS version 3.10 or above is required
  128.         DOS version is not compatible
  129.         An 80186 processor or better is required
  130.         Bad or missing program specification
  131.         User Interrupts 60h - 67h are in use
  132.  
  133. ================================================================================
  134.  
  135. (Warning Messages)::
  136.  
  137.         Unknown option in command line
  138.         Extra characters on command line
  139.  
  140. ================================================================================
  141.  
  142. (Advisory Messages)::
  143.  
  144. ================================================================================
  145.  
  146. (Report Messages)::
  147.  
  148.         User interrupt 00h hooked
  149.         Invalid Parameter for /D 00
  150.  
  151. ================================================================================
  152.  
  153. (Allocation Status)::
  154.  
  155. ================================================================================
  156.  
  157. (Changes)::
  158.  
  159. ================================================================================
  160.